home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d20 / renamrc1.arc / RENAMARC.DOC < prev   
Text File  |  1991-03-12  |  5KB  |  103 lines
  1. RENAMARC.COM (C)1991 By Maurice H. Warnon, SysOp of the Third Ring RBBS.
  2.                                             FidoNet Address: 1:272/30.0
  3.  
  4. RENAMARC.COM can be used by anyone, but is not free. It can be 
  5. distributed and copied as long as this documentation file 
  6. remains with it, and its content is unchanged.
  7. It is offered under the "DinnerWare" concept. This means that if you intend 
  8. to use this utility, you're obligated to take your spouse and/or friend out 
  9. for good dinner. Not for a fast food dinner: I worked too hard on this
  10. to get a cheap reward!
  11.  
  12. WARRANTY: The only warranty I can give you is that RENAMARC.COM 
  13. will occupy some space on your disk. 
  14.  
  15. RENAMARC.COM is a utility born, as many others, from frustration and despair.
  16. The Third Ring RBBS bearly survived a major desaster in november 1990, when
  17. my house was hit by lightening.
  18.  
  19. The bulletin board was running since 1984 without interruption. It contained 
  20. thousands of files and programs. Most of those safely backed up on diskettes 
  21. and tapes. The major problem was to locate and restore the user files and
  22. messages. Back up copies existed, but the most recent was a month old.
  23. The reason was that I didn't have a very simple procedure to identify backup 
  24. files automatically. This program has for primary purpose the creation of 
  25. backup files erasing themselves automatically according to a daily, weekly, 
  26. monthly or yearly schedule. A simple copy renamarc command issued from a 
  27. .BAT file, takes care of the cyclic backup business...
  28.  
  29. This utility is RENAMING (not copying) any file indicated in the first
  30. parameter with a new file extension determined by the current setting of 
  31. the resident clock on the Personal Computer. 
  32.  
  33. As an example, if files need to be backed up daily, but kept only for a week,
  34. the /S option is a good solution. The file will be updated on Monday with the 
  35. .MON extension, Tuesday with the .TUE extenstion, and so on... 
  36. The following week, the .MON file will be replaced by the new .MON file, 
  37. without affecting the other days: there will never be more than seven copies 
  38. of the backed up file. The same logic applies for the other options offered 
  39. by this utility.
  40.  
  41. Format:    RENAMARC <Filename.Ext> <Dest> </n> </v>
  42.  
  43. <Filename.Ext> is the name of the file to be renamed by RENAMARC.COM.
  44.  
  45. <Dest>         is a name (up to 8 chars) replacing <Filename>.
  46.           If <Filename> is to remain unchanged, the <Dest> parameter
  47.           is to be ignored, or contain the EXACT same information as 
  48.           the <Filename> parameter. A file cannot be renamed and moved
  49.           simultaneously into another drive or into another Directory.
  50.           The command will work with another Drive or 
  51.           Directory, if the renamed filed remains if the same directory 
  52.           as indicated in the <Filename> parameter.
  53.                Eg: on 01/01/1991: RENAMARC TEST.TST MYFILE /X
  54.             will rename TEST.TST as MYFILE.JAN
  55.          on 03/12/1991: RENAMARC TEST.TST /J
  56.             will rename TEST.TST as TEST.071
  57.          on 12/31/1991: RENAMARC D:\YEAREND\TEST.TST /Y
  58.             will rename TEST.TST as TEST.Y91 on 
  59.             the D: drive, and the \YEAREND Directory, but the
  60.             TEST.Y91 can only be located in the same location.
  61.  
  62. </n>          is the parameter indicating the choice of extension.
  63.           The choices are as follows:
  64.   Values of /n ->    /J    .Ext = .JJJ Julian Date    001 -> 366 (3 digits)
  65.         /Y    .Ext = .Yyy Char Y + YEAR  Y00 -> Y99 (2 digits)
  66.         /M    .Ext = .Mmm Char M + MONTH M01 -> M12 (2 digits)
  67.         /H    .Ext = .Hhh Char H + HOUR  H00 -> H23 (2 digits)
  68.         /D    .Ext = .Ddd Char D + DAY   D01 -> D31 (2 digits)
  69.         /X    .Ext = .MMM MONTH NAME     JAN -> DEC (3 alphas)
  70.         /S    .Ext = .DDD DAY NAME       MON -> SUN (3 alphas)
  71.  
  72. </v>          is the parameter allowing file security control:
  73.         /V    is the VERIFY option. It will detect if the new 
  74.             name already exists, and provides for operator's 
  75.             intervention by exiting with an errorlevel.
  76.         /O    will write over any file of the same name.
  77.  
  78. ERROR LEVELS: The use of DOS Errorlevels allows RENAMARC.COM to 
  79. be used in .BAT files with an adequate level of ease, Checking 
  80. the ERRORLEVEL's in the .BAT files will allow to automate the 
  81. process of archiving with sufficient control over unexpected 
  82. situations. Detection of dupplicated, inexisting, or erroneous files 
  83. can be taken care of. The files are renamed only when the 
  84. program exits with the Errorlevel set to 0 (Zero).
  85.  
  86.     Error Level
  87.     in RENAMARC            Description
  88.     0        File renamed. Normal exit.
  89.     1        No parameter found.
  90.     2        The file to be renamed doesn't exist.
  91.     3        When attempting to rename, a file was 
  92.             found with the same name. 
  93.             (For option VERIFY [/V] only).
  94.     8        An I/O error occured when writing 
  95.             over an existing file (Option /O only).
  96.     9        An I/O error occured when renaming the file.
  97.  
  98. Please report oddities and suggestions to: 
  99.             Maurice H. Warnon,
  100.             The Third Ring RBBS
  101.             FidoNet: 1:272/30.0
  102.             (914) 496 9259.
  103.